home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / topdoor.zip / TOPDOOR.DOC < prev   
Text File  |  1992-07-26  |  13KB  |  568 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                      Top Door Bulletin Generation Program
  33.  
  34.                      Copyright (c) 1992 By Mark G. Spivey
  35.  
  36.                           BBSPlus Software Utilities
  37.  
  38.                               All Rights Reserved
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.          PREAMBLE and CREDITS
  69.  
  70.          I would first  of all like  to thank Rachel,  my fiancee, who
  71.          put up  with me hanging  around in here  at all hours  of the
  72.          night without complaining! I love you!
  73.  
  74.          Second, I would  like to thank all of  the users who inspired
  75.          me to update this program after  I had decided to drop out of
  76.          FIDO net and give up, your letters got me going again.
  77.  
  78.          Third, I would  like to thank Karen Maynor  of The Dart Board
  79.          for  her help  in getting  this thing  off the  ground and my
  80.          programming started  up. I would  also like to  thank her for
  81.          use of  her board in  letting me release  my programs through
  82.          it.
  83.  
  84.          Fourth I would like to thank  my Beta Team: Norman Cox, Karen
  85.          Maynor,  Ken  Givens,  Steve  Proctor,  Jim  Thompson, Robert
  86.          Garbutt.
  87.  
  88.          There  will be  several other  program names  mentioned in my
  89.          documentation or other areas that are the respective programs
  90.          of their authors and are no way related to mine.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.          LICENSING INFORMATION
  135.  
  136.          "TOPDOOR"   refers   to   the   executable   program(s)   and
  137.          documentation  contained in  the TOPDOOR  archive released by
  138.          BBSPlus Software (Shareware Version).
  139.  
  140.          1. TOPDOOR  is the copywritten material  of BBSPlus Software.
  141.          It may only be used in accordance with the conditions set out
  142.          in this license agreement.
  143.  
  144.          2. You may use TOPDOOR for a period of three weeks on a trial
  145.          basis  in  order  to  determine  it's  suitability  for  your
  146.          particular application.  After this period  you MUST register
  147.          each copy of TOPDOOR  that you run simultaneously. Multi-line
  148.          installations that  share a common message  and file base AND
  149.          have the same name need only register one copy.
  150.  
  151.          3. Registration  entitles you to  use TOPDOOR and  any future
  152.          versions of TOPDOOR  for as long as you  wish, subject to any
  153.          special licensing conditions attached to future versions. For
  154.          details on  the registration procedure, refer  to the section
  155.          in this document "HOW TO REGISTER".
  156.  
  157.          4. BBSPlus Software is in  no way obligated to provide future
  158.          versions of, or support for, TOPDOOR.
  159.  
  160.          5. Site and Group registrations  are available, and are dealt
  161.          with on a case by case basis.
  162.  
  163.          6. You may not modify or otherwise reverse-engineer TOPDOOR.
  164.  
  165.          7. You are encouraged to  distribute TOPDOOR provided that no
  166.          fee   is  charged   for  its   distribution,  and   that  the
  167.          distribution archive is not modified in any way. Pay Bulletin
  168.          Board Systems  may however charge  their normal fee  provided
  169.          that no additional charged for TOPDOOR is levied.
  170.  
  171.          8. TOPDOOR  may be included  as part of  ANY software library
  172.          which is distributed on a commercial basis (commercial = "for
  173.          money").
  174.  
  175.          9. TOPDOOR may not be used in any illegal or unlawful manner.
  176.  
  177.          10. BBSPlus  Software's liability resulting from  your use or
  178.          inability to  use TOPDOOR is  limited to the  amount that the
  179.          affected party has paid for it,  or in the event that TOPDOOR
  180.          was  registered with  a third  party for  payment to  BBSPlus
  181.          Software,  liability  is  limited  to  the  amount  that  was
  182.          received by BBSPlus Software from that third party.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.          HOW TO REGISTER
  201.  
  202.          Shareware version:
  203.  
  204.          Systems that qualify for this category must be physically run
  205.          from a noncommercial OR commercial site.
  206.  
  207.          Print or reproduce  the registration form at the  end of this
  208.          section  and send  it with  your registration  payment to the
  209.          following address:
  210.  
  211.          Mark Spivey            Cost: $5.00
  212.          Registration/TOPDOOR
  213.          2900 Colerain Rd.  #938
  214.          St. Mary's,  GA  31558
  215.          USA
  216.  
  217.          * You MUST fill out the  registration form correctly in order
  218.          for your registration to be processed.
  219.  
  220.          * Check and money orders should be made payable to the person
  221.          listed above.
  222.  
  223.          * Please  include your  FIDONET address  or a  self addressed
  224.          stamped  envelope  so  that  receipt  of  your payment may be
  225.          acknowledged.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                   *** TOPDOOR REGISTRATION FORM ***
  267.  
  268.          Your Name ________________________________________________
  269.  
  270.          Your BBS Name ____________________________________________
  271.  
  272.          Network Address (net name too) ___________________________
  273.  
  274.          Primary BBS # and Baud ___________________________________
  275.  
  276.          Voice Telephone # ________________________________________
  277.  
  278.          Hours of Operation _______________________________________
  279.  
  280.          Postal Address :
  281.  
  282.          __________________________________________________________
  283.  
  284.          __________________________________________________________
  285.  
  286.          __________________________________________________________
  287.  
  288.          Version Registering __________.
  289.  
  290.          Registration Amount enclosed _____, for ____ copy(s).
  291.  
  292.          What do you like about TOPDOOR? ___________________________
  293.  
  294.          ___________________________________________________________
  295.  
  296.          ___________________________________________________________
  297.  
  298.          What suggestions would you have for TOPDOOR? ______________
  299.  
  300.          ___________________________________________________________
  301.  
  302.          ___________________________________________________________
  303.  
  304.          What BBS program do you use? ______________________________
  305.  
  306.          What Mailer do you use? ___________________________________
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.          PRODUCT SUPPORT
  333.  
  334.          You can always get the latest version of TOPDOOR from my BBS,
  335.          Online  Information  Systems,  912-882-8667.  I  will support
  336.          anyone  100%  via  this  system  or  netmail whether you have
  337.          registered or not.  I carry an echo for  support which may be
  338.          placed on the backbone one day which will make it easier. The
  339.          reason that I will  support registered users AND unregistered
  340.          users is that  I have wanted to use a  program and the author
  341.          felt I should register it before  he would help me. This made
  342.          me delete the program and refuse to use it ever again.
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.          BUG REPORTS
  399.  
  400.          With all software, there are going to be a few bugs that were
  401.          not found during the BETA  testing period. This is normal and
  402.          is  much easier  to fix  with  the  help of  the user  of the
  403.          software.  If you  notice anything  weird happening  and have
  404.          found it  to be my programs  fault, I would appreciate  it if
  405.          you let me know. I will see if the bug exists and if you have
  406.          in  fact  found  a  bug, (and are the first to report it)
  407.          I  will  grant  you a FREE version.
  408.  
  409.          Hopefully this  will give more  incentive to helping  me find
  410.          problems in my software. You may reach me via FIDO netmail at
  411.          address 1:3640/13. This will allow  a much faster response to
  412.          the problem. If you prefer US MAIL you can reach me at:
  413.  
  414.          2900 Colerain Rd. #938 St. Mary's, Ga 31558
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.         ---------------------[ TOPDOOR.EXE ]----------------------
  465.  
  466.          PURPOSE
  467.  
  468.          This program will  generate a top ten doors  list in ANSI and
  469.          ASCII  format. Having  a top  door list  can make  your users
  470.          interested in the doors that get  used the most. The file can
  471.          be placed anywhere in your log  in path. I recommend you place
  472.          it as  an autoexecute from your main menu so there will  be a
  473.          pause at the end for the user to read the bulletin in time.
  474.  
  475.          CONFIGURATION
  476.  
  477.          Place all of  the files into a directory  called TOPDOOR (you
  478.          may change this at any time, but make sure you edit the batch
  479.          file TDINC.BAT to the proper path.)
  480.  
  481.          Place  the file  TDINC in  your path  somewhere so  it can be
  482.          called from any directory in your system.
  483.  
  484.          Edit the batch  files which execute your doors  and after the
  485.          completion of each door add this line.
  486.  
  487.          CALL TDINC (this is the name of the door as set up with
  488.                      TDMAINT excluding the parenthesis)
  489.  
  490.          Case is  sensitive and you  should write down  on a piece  of
  491.          paper the name you  used so the program will count correctly.
  492.          Do this for all batch files which execute doors INCLUDING the
  493.          ones contained in your EXEBBS  batch file (if applicable). On
  494.          my system I have all of the  doors in one batch file and send
  495.          a parameter  to  this  file  which  will  call the proper sub
  496.          routine.   This is merely preference.
  497.  
  498.          Next  you need  to enter   the names  into the  database with
  499.          TDMAINT.EXE. This  is pretty simple,  you can either  ADD the
  500.          names or  DELETE an old door  from the list. If  you are done
  501.          adding names, press ENTER and the program will close the file
  502.          and exit. The next version (beta that is) will hopefully have
  503.          a revamped  editor available  with  an  option to  import the
  504.          names automatically  from all of  your batch files  on all of
  505.          your drives,   I will have to work HARD on that one.
  506.  
  507.          Once you have  the name in the database you  need to edit the
  508.          configuration file as explained below.
  509.  
  510.          Line 1 - Name of your BBS as you would  like  it to appear in
  511.          the TOP CALL files.  Cannot exceed 38 chars.
  512.  
  513.          Line 2 - Path  and  filename  WITHOUT an  extension of TOP 10
  514.          DOORS
  515.  
  516.          Color Chart
  517.               1 - Red              9 - Light Red
  518.               2 - Green           10 - Light Green
  519.               3 - Brown           11 - Yellow
  520.               4 - Blue            12 - Light Blue
  521.               5 - Magenta         13 - Light Magenta
  522.               6 - Cyan            14 - Light Cyan
  523.               7 - White           15 - Bright White
  524.               8 - Grey
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                Color 1 ->    Created by TOPDOOR by Mark G. Spivey
  531.                Color 2 ->               Top Ten Doors
  532.                Color 3 ->        ONLINE INFORMATION SYSTEMS
  533.                Color 4 ->  ---------------------------------------
  534.                                          Color 6 \/
  535.                Color 5 ->  MARK SPIVEY ..............  46  <- Color 7
  536.  
  537.          Line 3 - Color1
  538.          1
  539.          Line 4 - Color2
  540.          2
  541.          Line 5 - Color3
  542.          3
  543.          Line 6 - Color4
  544.          4
  545.          Line 7 - Color5
  546.          5
  547.          Line 8 - Color6
  548.          6
  549.          Line 9 - Color7
  550.          7
  551.  
  552.          EXECUTION
  553.  
  554.          At night during your maintenance event, change to the TOPDOOR
  555.          directory and execute TDCOUNT.EXE for the program to increase
  556.          the  counters. After  this program  is completed  you will be
  557.          able to  run TDBULLET.EXE which will  create the bulletin you
  558.          defined in the configuration file. All other execution should
  559.          be transparent  and not even noticed.  The reason TDCOUNT and
  560.          TDBULLET are  two files is  this, if you  have a VERY  active
  561.          system and there will be more than 500 lines in the doors.cnt
  562.          file (the  file with the names  of the doors in  it) then you
  563.          need to run this program more than  once a day as this is the
  564.          limit per  session. There also  is a limit  to the number  of
  565.          doors you can  have: 200. If  this is  not enough for ANYONE,
  566.          please contact me via my system 1:3640/13 and I will make you
  567.          a special version which can handle as many as you like.
  568.